home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 February: Tool Chest / Dev.CD Feb 97 TC.toast / Tool Chest / OS Utilities / Gestalt Selectors List 3.6 / Updates / Update 3.5.4 < prev   
Encoding:
Text File  |  1996-10-11  |  20.0 KB  |  513 lines  |  [TEXT/R*ch]
  1.  
  2. Dear reader,
  3.  
  4. Four years ago I innocently believed it wouldn't be much work to compile a
  5. list of Gestalt selectors. It was even before I took up Pascal programming
  6. and I wanted the selectors because of my use of a 4th Dimension external
  7. called 'Gestalt'. Later I wrote my own, extended, version of the external.
  8. Marco Piovanelli, who suggested to compile a list of selectors, still
  9. thinks I also should start a list of Apple events. But I'am not buying
  10. that anymore! ;-)
  11.  
  12. Luckily I'am not doing all of this on my own, I get help from numerous
  13. people. I want to thank all who contributed and helped, but especially
  14. these people:
  15. - Jos van Wezel, my UNIX operator, for the many hours he had to spend to
  16.   keep the mail and mailing list working. He should get an array of
  17.   Macs... :-)
  18. - Jean-Pierre Curcio, for the unlimited flow of emails with new findings,
  19.   corrections and ofcourse regular updates of his Gestalt.Appl.
  20. - Fabrizio Oddone and Marco Piovanelli (both Italian but never met each
  21.   other!) for their many contributions.
  22. - Masatsugu 'Mark' Nagata for his contributions. He has almost all
  23.   available extensions and control panels installed so he contributed many
  24.   Third Party selectors. For a non-programmer he knows a lot about using
  25.   Macsbug!
  26. - Quinn and Rich Kubota (both at Apple's Developer and Technical Support)
  27.   for their contributions and clarifications.
  28.  
  29. What a nice birthday presents we got! The new mach ID for the Motorola
  30. Starmax and the value for the PowerPC 603ev and 604e processors! Also more
  31. info for the 'iic ' selector. And some info related to Harmony
  32. (System 7.6). But the theme for this update is 'Motorola'! :-)
  33.  
  34. For those people interested, here are some annual tidbits about the GSL:
  35. (including this update and GSL 3.6)
  36. Releases          :   25
  37. Updates           :  116
  38. Number of Days    : 1461
  39. Approx. time spend
  40. by Editor         : 1461 days * 30 min./day = 43.830 min. = 730 hr.
  41. Observations      : 9901 selectors and responses now in a data-base
  42.                     (from Gestalt! and Gestalt.Appl files)
  43. Subscribers       :  171
  44. Contributors      :  103 (343 contributions)
  45. Size text         : 314136 bytes (114 A4 or 123 US Letter pages)
  46. GSL Home Web usage: 2703 visits (as of 10 Oct. 20:06 PM)
  47.  
  48. Selector count    :
  49.     Category                       Overall              Apple Only
  50.     Apple System Software          150      24,6%        150
  51.     Apple Additional Software       29       4,8%         29
  52.     Third Parties Software          72      11,8%
  53.                                    ---     -----         ---
  54.       Subtotal known                   251         41,1%     179  56,1%
  55.     Unknown Apple Software         140      23,0%            140  43,9%
  56.     Unknown Third Parties Software 219      35,9%
  57.                                    ---     -----
  58.       Subtotal unknown                 359         58,9%
  59.                                        ---        -----      --- -----
  60.       Total                            610        100,0%     319 100,0%
  61.  
  62. Included with this release is also a file 'GSL Release History' which lists
  63. releases (full and updates) with the main topics.
  64.  
  65. I must also point you to the file 'GSL Survey 1996' which includes a few
  66. multiple choice and open questions for this years survey. Please fill it in
  67. and return it to me. More details are in that same file.
  68.  
  69. With regard to the FileMaker Pro data-base: it isn't as far as I hoped.
  70. It would have been nice to start using it with this release but there is one
  71. major step to be taken: compiling and exporting the data into several formats.
  72. However, I made a start with the compiler to do that task and the file
  73. 'GSL Release History' was the first, and easiest, result so far.
  74. Those who have seen and used the data-base are impressed. It really gets to the
  75. limits of FileMaker, not for the speed but for the features used. I.e. it has
  76. it's own search engine to search multiple files from one central place.
  77. Anyway, I'am still working on it.
  78.  
  79. Best regards,
  80. Rene Ros
  81.  
  82.  
  83.  
  84. Gestalt Selectors List 3.5.4 Update
  85. ===================================
  86.  
  87. Maintained and published by Rene G.A. Ros (rgaros@bio.vu.nl)
  88.  
  89. First published: 12 October 1992, 13:15 CET (GMT+1)
  90. Last version   : 8 August 1996, 17:30 CET (GMT+2, DST)
  91. Previous update: 30 September 1996, 21:45 CET (GMT+2, DST)
  92. Last modified  : 12 October 1996, 12:15 CET (GMT+2, DST)
  93.  
  94. The complete version is available to subscribers by sending an email to:
  95.      gestalt-selectors-list-request@bio.vu.nl
  96. with as subject:
  97.      archive get recent/gestalt-selectors.etx
  98. or to get the compressed version:
  99.      archive get recent/gestalt-selectors.sit.hqx
  100. The latest GSL version is also available on the GSL Web page. Point your
  101. Internet browser to:
  102.      http://www.bio.vu.nl/home/rgaros/gestalt/
  103.  
  104. If this is the first update you receive since subscribing to the mailing
  105. list you may want to get the previous updates as well. Then email to the
  106. address listed above and use this command:
  107.      archive get updates/updates-comb.etx
  108.  
  109. A vertical bar in front of a line indicates the line has changed or was
  110. added.
  111.  
  112. PLEASE SEND COMMENTS AND CORRECTIONS TO THE EDITOR AS SOON AS POSSIBLE.
  113.  
  114. The following persons contributed to this update:
  115.  
  116. ===========================================================================
  117. Contributions to the selector sections
  118. ===========================================================================
  119. Person                 Software                Selector(s) added/changed
  120. ---------------------------------------------------------------------------
  121. Anonymous 3            System                  cput (0x109),
  122.                                                mach (Motorola #514)
  123. Anonymous 4            System                  mach (#311)
  124. Anonymous 5            System                  hrad (Harmony)
  125.                        WalkInit ext            walk
  126. Jean-Pierre Curcio     System                  bmgv, cput (0x107), flpy,
  127.                                                hrad (Starmax), sltc
  128. Ray Montagne           System ?                iic 
  129. Masatsugu Nagata       IRTalk cp or System ?   irhw
  130. Rene Ros               CacheSaver cp           fCch
  131.                        PC Setup cp?            pc  
  132.                        System                  cput (0x107, X704)
  133. ---------------------------------------------------------------------------
  134.  
  135. ===========================================================================
  136. Contributions to the non-selector sections
  137. ===========================================================================
  138. Person                 Chapter/Section
  139. ---------------------------------------------------------------------------
  140. 'shy contributor'      Reports/Manufacturer Identification
  141. ---------------------------------------------------------------------------
  142.  
  143. Apple System Software (A-D)
  144. ===========================
  145.  cput (System [7.1.2?]) &AS04/AS05
  146.       gestaltNativeCPUtype
  147.       Returns a value that indicates the type of native processor that is
  148.       currently running.
  149.  
  150.       enum {
  151.       #define gestaltNativeCPUtype 'cput' /* Native CPU type */
  152.       /* Motorola Architecture */
  153.       gestaltCPU68000 = 1,
  154.       gestaltCPU68010 = 2,
  155.       gestaltCPU68020 = 3,
  156.       gestaltCPU68030 = 4,
  157.       gestaltCPU68040 = 5,
  158.  
  159.       /* PowerPC Architecture */
  160.       gestaltCPU601   = 0x101,
  161.       gestaltCPU603   = 0x103,
  162.       gestaltCPU604   = 0x104,
  163.       gestaltCPU603e  = 0x106,  /* &AS22 */
  164. |     gestaltCPU603ev?= 0x107,
  165. |     gestaltCPU604e? = 0x109,
  166.  
  167.       /* PowerPC Architecture (Unreleased & Rumoured) */
  168.       gestaltCPU613?  = ???,
  169.       gestaltCPU614?  = ???,
  170.       gestaltCPU615?  = ???,
  171.       gestaltCPU620?  = ???,
  172.       gestaltCPU630?  = ???,
  173.  
  174. |     gestaltCPU704?  = ???};   /* X704 500-MHz from Exponential */
  175. |                               /*  Technology Inc. */
  176.  
  177.       NOTE:
  178.       The 'cput' selector is available on all Macs running System 7.5 or
  179.       later and sometimes with System 7.1. If not available, use 'proc'
  180.       selector. &AS22
  181.  
  182.       According to Universal Interfaces 3.0d3 Gestalt.h header file the
  183.       Quadra 660AV and Quadra 840AV with System 7.1 always return 5 because
  184.       of a ROM bug. But since they have a M68040, 5 is the correct value?
  185.       Or after an PPC upgrade these two machines still return 5?
  186.       System 7.5 fixes this problem. &AS22
  187.  
  188.       The GestaltEqu.h file published with E.T.O. #12 was replaced by the
  189.       one on E.T.O. #13. However there was made a mistake, it lists the 68K
  190.       values in the range 0-4 while it should be 1-5 as listed above.
  191.       This problem is acknowledged by Apple.
  192.       You can fix this problem by using the declarations listed above or by
  193.       using the GestaltEqu.h file from E.T.O. #13 but then test first the
  194.       gestaltSysArchitecture ('sysa') selector and when it reports a 68K
  195.       machine use gestaltProcessorType.
  196.       However, System 7.5 and later were apperantly created using the
  197.       incorrect header file and return the incorrect values.
  198.       Example: 'cput' returns 3 and 'proc' returns 4.
  199.       (Anonymous, Dave Radcliffe, Roland Mansson, Rene Ros)
  200.       Now it seems a bug is made into a feature. The latest Gestalt
  201.       header files explicity states the range 0-4 is the correct one. And
  202.       the value returned on a Quadra 660AV and Quadra 840AV is indeed
  203.       incorrect. I'am confused by all this, are you? (Rene Ros)
  204.  
  205.       To check whether the native system architecture is a MC680x0 or a
  206.       PowerPC use the gestaltSysArchitecture ('sysa') selector. See for
  207.       more information on the 68K processors the gestaltProcessorType
  208.       ('proc') selector.
  209.  
  210. Apple System Software (E-H)
  211. ===========================
  212.  hrad (Mac OS Licensing Extension ext [???])
  213.       (System? [7.5.3?])
  214.       (System 7.5 Update enbl [2.0])
  215.       gestaltHardwareVendorCode &AS22
  216.       Returns hardware vendor information.
  217.  
  218.       #define gestaltHardwareVendorCode 'hrad'
  219.       #define gestaltHardwareVendorApple 'Appl' /* Hardware built by */
  220.                                                 /*  Apple Computer Inc. */
  221.       #define gestaltHardwareVendorPCC?  'pcc ' /* Hardware built by */
  222.                                                 /*  Power Computing Corp. */
  223.  
  224.       NOTE:
  225.       This selector is backwards compatible with Macintosh compatibles introduced
  226.       before System 7.5.3 was introduced? The response 'pcc ' is returned when
  227.       using System 7.5.3 on a Power Computer Power 100.
  228.  
  229.       System 7.5.3 on a PowerCurve 601/120 does not install this selector
  230.       nor 'srad'. (Mark Schrier)
  231.       Selector installed and returning 'pcc ' on a Power Computing Power 100.
  232.       (John Tsombakos)
  233.      
  234. |     On a Motorola Starmax and with Harmony the value 0 is returned.
  235.  
  236.       See also the 'srad' selector in this section.
  237.  
  238.       See for more information on this selector and its twin 'srad', the
  239.       'Manufacturer Identification' section in the 'Reports' chapter.
  240.  
  241. Apple System Software (I-L)
  242. ===========================
  243.  iic  (System? [7.5?])
  244.       gestaltIICAttr &AS19
  245.       Returns information about the Inter-Integrated Circuit Bus (IIC).
  246.  
  247.       enum {
  248.       #define gestaltIICAttr 'iic ' /* Inter-Integrated Circuit Bus */
  249.       gestaltStdIIC         = 0,    /* standard IIC */
  250.       gestaltCombinedIIC    = 1,    /* combined format IIC */
  251.       gestaltExtendedIIC    = 2,    /* extended IIC */
  252.       gestaltMultiIIC       = 3,    /* multiple bus master IIC */
  253.       gestaltGeneralCallIIC = 4,    /* general call IIC */
  254.       gestaltFastIIC        = 5,    /* fast IIC */
  255. |     gestaltMBUS_IIC       = 6};   /* Motorola MBUS hardware IIC bus master */
  256.  
  257. |     NOTE:
  258. |     Bit 6 of the 'iic ' gestalt has been defined to indicate MBUS support.
  259. |     MBUS is a hardware module within some versions of a Motorola 6805
  260. |     microcontroller which is used to implement the Inter-Integrated
  261. |     Circuit Bus and allows for higher throughput than the Inter-Integrated
  262. |     Circuit Bus master that is implemented in firmware when no MBUS module
  263. |     is available. (Ray Montagne)
  264.  
  265. Apple System Software (M)
  266. =========================
  267.  mach (System [6.0.4]) INF
  268.       gestaltMachineType
  269.       Returns one of the following values, indicating the type of
  270.       machine.
  271.  
  272.       enum {
  273.       #define gestaltMachineType 'mach' /* machine type */
  274.  
  275. |     gestaltPowerBook1400cs?       = 310, /* PowerBook 1400cs */
  276. |     gestaltEpic?                  = 311, /* PB? codenamed Epic */
  277. |     gestaltMotorolaStarmax?       = 514, /* Motorola Starmax; codename */
  278. |                                          /*  for board is Tanzania */
  279. |                                          /*  first to have own mach*/
  280. |                                          /*  IDs! (10/96) */
  281.       };
  282. [other values and not omitted here]
  283.  
  284. Apple System Software (N-O)
  285. ===========================
  286. No changes.
  287.  
  288. Apple System Software (P-S)
  289. ===========================
  290.  sltc (System [6.0.8?])
  291.       gestaltNuBusConnectors
  292.       Returns information about the NuBus slot connector locations. The
  293.       value returned is a bitmap. If bits 9 to E are set, there are six
  294.       slots present with locations 9 to E.
  295.  
  296.       #define gestaltNuBusConnectors 'sltc' /* NuBus connector bitmap */
  297.  
  298.       NOTE:
  299.       This selector does not return information about the PDS slot (with
  300.       or without NuBus adapter). Also, it is unknown if this selector also
  301.       includes slot 0x8 which was added with the Power Macintosh 8100/110.
  302.       (John Mancino)
  303.  
  304. |     On Motorola Starmax it returns 0x0000FFFF. Does it have NuBus slots???
  305.  
  306. Apple System Software (T-Z)
  307. ===========================
  308. No changes.
  309.  
  310. Apple Additional Software
  311. =========================
  312. |pc   (PC Setup cp? [???])
  313. |     gestaltDOSCompatibleState &AD23
  314. |     Returns information about the state of the DOS Compatible system.
  315. |
  316. |     enum {
  317. |     #define gestaltDOSCompatibleState 'pc  '
  318. |     gestaltPCInstalled      = 0,  /* PC Setup Init is installed */
  319. |     gestaltPCRunning        = 1,  /* If bit set, the PC system is */
  320. |                                   /*  running */
  321. |     gestaltPCHasTakenOver   = 2,  /* If bit set, the PC system is in */
  322. |                                   /*  the foreground */
  323. |     gestaltPCSharingMonitor = 3}; /* If bit set, there is no dedicated */
  324. |                                   /*  monitor for the PC system */
  325.  walk (WalkInit ext [1.0?])
  326.       gestaltWalkaboutVers
  327. |     Returns the version of the Walkabout (codename?) extension as
  328. |     NumVersion. (Anonymous)
  329.  
  330.       #define gestaltWalkaboutVers 'walk'
  331.  
  332. Third Parties Software
  333. ======================
  334. No changes.
  335.  
  336. Unknown Apple Software
  337. ======================
  338. |bmgv (??? [???])
  339. |     Observed value: 0x10 on Motorola Starmax; 0x00010005 with Harmony.
  340.  
  341.  flpy (System? [7.5.2?])
  342. |     Observed value: 0. Value found on Performa 5400, Performa 6400 and
  343. |     Motorola Starmax.
  344.  
  345. |irhw (IRTalk ext ? or System ? [???] ?)
  346.       ????
  347.  
  348.       NOTE:
  349.       On a PM 7100 with System 7.5.3 universal this selector returns noErr
  350.       and a response value of zero. (Jean-Pierre Curcio)
  351. |     It returns 4 on a PowerBook 5300ce (System 7.5.5 US) but it crashes
  352. |     MacsBug. Only by replacing 'eajt' in the Gestalt dcmd of MacsBug 6.5.3
  353. |     with 'irhw' ('eajt' is ignored by the Gestalt dcmd!) the crash can be
  354. |     diverted. (Masatsugu Nagata)
  355.  
  356. Unknown Third Parties Software
  357. ==============================
  358. |fCch (CacheSaver cp [1.0?] by St.Clair Software)
  359.  
  360. Reports
  361. =======
  362.  
  363. |Manufacturer Identification
  364. |---------------------------
  365. |
  366. |There are two selectors to identify the hardware and software manufacturer
  367. |of the computer. These selectors, 'hrad' and 'srad' respectively, are at
  368. |least available since system 7.5.3.
  369. |
  370. |The selector 'hrad' is for hardware identification purposes. An Apple
  371. |machine should identify itself as 'Appl'. An undefined selector error
  372. |should be interpreted as 'Appl', anything else is a clone. For example, a
  373. |Power Computing machine should return 'pcc '. An exception to this is
  374. |licensee systems built using Apple motherboards: there's no way to identify
  375. |them.
  376. |
  377. |The selector 'srad' is for software identification purposes. It identifies
  378. |software by who sold the software and is mainly for customer support use.
  379. |Software sold with a licensee computer is always identified as sold by the
  380. |licensee. But, if for example, a licensee customer goes out and buys a
  381. |shrinkwrap version of the MacOS, then the software was purchased from Apple
  382. |and will be supported by Apple.
  383. |Typical responses are 'Appl' for Apple and 'Lcns' for licensees, although
  384. |in the latter case, licensees are allowed to customize it further with
  385. |their own identifier.
  386. |The system software should set the selector, although that hasn't been done 
  387. |consistently because of some bugs. For newer machines, the selectors may be
  388. |set by the "Mac OS Licensing Extension" which only ships on clone machines
  389. |and is used to handle some licensing specific stuff. (Oct. 96)
  390.  
  391. General Info
  392. ============
  393.  
  394. Sources
  395. -------
  396.  A    Apple Computer, Inc.
  397.  AD    Documentation & Magazines
  398. |AD33   12 & 7 PC Compatibility Cards documentation
  399.  
  400. About this list
  401. ===============
  402. For this update this chapter only includes the 'Gestalt Submission Form',
  403. 'Acknowledgements' and 'Editors' Address' sections.
  404.  
  405. Gestalt Submission Form
  406. -----------------------
  407. You can use this form to report information you found on already included
  408. selectors. But you can also use it to register new Gestalt selector codes.
  409. If you want to register the selector code your software installs, make sure
  410. you registered your code first with Apple Computer, Inc. Also, it is your
  411. good right if you chose to keep the meaning of the response value private.
  412. If so, still register so that others can at least detect your software by
  413. determining if the selector is present.
  414.  
  415. Software means, in this form, the software which installs the selector
  416. code. Not the whole package, just the extension or control panel (perhaps
  417. application) itself.
  418. The package is the product name in which the software is included and
  419. distributed.
  420. If data is not available or relevant, leave it blank. When the selector
  421. contains non-ASCII characters, please also provide the hexadecimal value.
  422.  
  423. You can also fill in this form on-line because it is also on the WWW
  424. pages of the GSL: http://www.bio.vu.nl/home/rgaros/gestalt/
  425.  
  426.  
  427. Your name: 
  428.  
  429. Your email address: 
  430.  
  431. Your company name: 
  432.  
  433. Do you want to remain anonymous? Yes / No
  434.  
  435. Software name: 
  436.  
  437. Software type: O application 
  438.                O control panel
  439.                O extension (also 'appe')
  440.                O other:
  441.  
  442. Category:      O Apple System Software
  443.                O Apple Additional Software
  444.                O Apple Software
  445.                O Third Parties Software
  446.  
  447. Package name: 
  448.  
  449. Author or Company name: 
  450.  
  451. Gestalt Selector: 
  452.  
  453. Constant name: 
  454.  
  455. First version to install selector: 
  456.  
  457. Source of information: 
  458.  
  459. Short description of the returned response:
  460.  
  461.  
  462.  
  463.  
  464.  
  465. Additional constant names and values for the response value meaning:
  466.  
  467.  
  468.  
  469.  
  470.  
  471. Please email this form to this Internet address: rgaros@bio.vu.nl
  472.  
  473. Acknowledgements
  474. ----------------
  475. I want to thank the following persons for their contributions to this
  476. update and their support of this list:
  477.  
  478. ===========================================================================
  479. Name                                       Internet Email Address
  480. ---------------------------------------------------------------------------
  481. Anonymous contributor(s)                   anonymous@secret.bvd.nl
  482. Jean-Pierre Curcio                         JPC83@calvacom.fr
  483. Ray Montagne, Apple Computer Inc.          MONTAGNE1@apple.com
  484. Masatsugu Nagata                           nagata@kurims.kyoto-u.ac.jp
  485. ---------------------------------------------------------------------------
  486.  
  487. Legal Stuff
  488. -----------
  489. (C) 1992-1996, Rene G.A. Ros
  490.  
  491. It is not allowed to distribute the GSL updates separate from the full GSL.
  492. The full GSL can be used freely but is not public domain.
  493. See for legal information the Legal Stuff chapter of the full Gestalt
  494. Selectors List.
  495.  
  496. Editor's Address
  497. ----------------
  498. Rene G.A. Ros
  499. developer at Mac Support Automatisering B.V., Uitgeest, The Netherlands
  500. consultant to the Computer Department,
  501.     Biology Faculty, Vrije Universiteit Amsterdam, The Netherlands
  502. contract programmer Pascal and C, also 4th Dimension and other data-bases
  503.  
  504. Bastionweg 108
  505. 1383 JD Weesp
  506. The Netherlands, Europe
  507.  
  508. Phone: +31 294 413167
  509. Email: rgaros@bio.vu.nl (preferred)
  510.        rgaros@dds.nl
  511.        ros@macsupport.nl
  512.        100112.1363@compuserve.com
  513.